home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 1999 August / SGI Freeware 1999 August.iso / dist / fw_urt.idb / usr / freeware / catman / u_man / cat1 / rlecomp.Z / rlecomp
Encoding:
Text File  |  1999-01-26  |  3.9 KB  |  133 lines
  1.  
  2.  
  3.  
  4.      RRRRLLLLEEEECCCCOOOOMMMMPPPP((((1111))))           1111 ((((DDDDeeeecccceeeemmmmbbbbeeeerrrr 22220000,,,, 1111999988886666))))        RRRRLLLLEEEECCCCOOOOMMMMPPPP((((1111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.       rlecomp - Digital image compositor
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.       rrrrlllleeeeccccoooommmmpppp [ ----oooo _o_u_t_f_i_l_e ] _A_f_i_l_e _o_p_e_r_a_t_o_r    _B_f_i_l_e
  13.  
  14.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.       _r_l_e_c_o_m_p implements an    image compositor based on presence of
  16.       an alpha, or matte channel the image.     This extra channel
  17.       usually defines a mask which represents a sort of a cookie-
  18.       cutter for the image.     This is the case when alpha is    255
  19.       (full    coverage) for pixels inside the    shape, zero outside,
  20.       and between zero and 255 on the boundary. If _A_f_i_l_e or    _B_f_i_l_e
  21.       is just a single -, then _r_l_e_c_o_m_p reads that file from    the
  22.       standard input.
  23.  
  24.       The operations behave    as follows (assuming the operation is
  25.       "_A _o_p_e_r_a_t_o_r _B"):
  26.  
  27.       oooovvvveeeerrrr The result will be the union of the two image shapes,
  28.            with _A obscuring    _B in the region    of overlap.
  29.  
  30.       iiiinnnn   The result is simply the    image _A    cut by the shape of _B.
  31.            None of the image data of _B will    be in the result.
  32.  
  33.       aaaattttoooopppp The result is the same shape as image _B,    with _A
  34.            obscuring _B where the image shapes overlap.  Note this
  35.            differs from oooovvvveeeerrrr because the portion of    _A outside _B's
  36.            shape does not appear in    the result.
  37.  
  38.       oooouuuutttt  The result image    is image _A with    the shape of _B cut
  39.            out.
  40.  
  41.       xxxxoooorrrr  The result is the image data from both images that is
  42.            outside the overlap region.  The    overlap    region will be
  43.            blank.
  44.  
  45.       pppplllluuuussss The result is just the sum of the image data.  Output
  46.            values are clipped to 255 (no overflow).     This
  47.            operation is actually independent of the    alpha
  48.            channels.
  49.  
  50.       mmmmiiiinnnnuuuussss
  51.            The result of _A - _B, with underflow clipped to zero.
  52.            The alpha channel is ignored (set to 255, full
  53.            coverage).
  54.  
  55.       ddddiiiiffffffff The result of abs(_A - _B).  This is useful for comparing
  56.            two very    similar    images.
  57.  
  58.       aaaadddddddd  The result of _A + _B, with overflow wrapping around (_m_o_d
  59.            256).
  60.  
  61.  
  62.  
  63.      Page 1                         (printed 12/1/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      RRRRLLLLEEEECCCCOOOOMMMMPPPP((((1111))))           1111 ((((DDDDeeeecccceeeemmmmbbbbeeeerrrr 22220000,,,, 1111999988886666))))        RRRRLLLLEEEECCCCOOOOMMMMPPPP((((1111))))
  71.  
  72.  
  73.  
  74.       ssssuuuubbbbttttrrrraaaacccctttt
  75.            The result of _A - _B, with underflow wrapping around
  76.            (_m_o_d 256).  The aaaadddddddd and ssssuuuubbbbttttrrrraaaacccctttt    operators can be used
  77.            to perform reversible transformations.
  78.  
  79.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  80.       _u_r_t(1), _R_L_E(5),
  81.       "Compositing Digital Images",    Porter and Duff, _P_r_o_c_e_e_d_i_n_g_s
  82.       _o_f _S_I_G_G_R_A_P_H '_8_4 p.255
  83.  
  84.      AAAAUUUUTTTTHHHHOOOORRRRSSSS
  85.       Rod Bogart and John W. Peterson
  86.  
  87.      BBBBUUUUGGGGSSSS
  88.       The other operations could be    optimized as much as oooovvvveeeerrrr is.
  89.  
  90.       _R_l_e_c_o_m_p assumes both input files have    the same number    of
  91.       channels.
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                         (printed 12/1/98)
  130.  
  131.  
  132.  
  133.